home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Environments / Prograph Classic 2.6.1 / Prograph Reference Manual / Prograph Reference 5-7 / Prograph Reference 5-7.rsrc / TEXT_178.txt < prev    next >
Encoding:
Text File  |  1995-10-25  |  6.7 KB  |  238 lines

  1.  
  2. Round Rectangles
  3.  
  4. In the following routines, ovalWidth and ovalHeight specify the diameters of curvature for the corners.
  5.  
  6.  
  7. __________________________________________
  8. FrameRoundRect  *399*
  9.  
  10. Input names:   r, ovalWidth, ovalHeight
  11.  
  12. Input types:   Rect, integer, integer
  13.  
  14. Description:   Draws an outline just inside the specified rounded-corner rectangle, using the current grafPort‚Äôs pen pattern, mode, and size. 
  15.  
  16.  
  17. __________________________________________
  18. PaintRoundRect  *399*
  19.  
  20. Input names:   r, ovalWidth, ovalHeight 
  21.  
  22. Input types:   Rect, integer, integer
  23.  
  24. Description:   Paints the specified rounded-corner rectangle with the current grafPort‚Äôs pen pattern and mode.
  25.  
  26.  
  27. __________________________________________
  28. EraseRoundRect  *399*
  29.  
  30. Input names:   r, ovalWidth, ovalHeight 
  31.  
  32. Input types:   Rect, integer, integer
  33.  
  34. Description:   Paints the specified rounded-corner rectangle with the current grafPort‚Äôs background pattern bkPat.
  35.  
  36.  
  37. __________________________________________
  38. InvertRoundRect  *399*
  39.  
  40. Input names:   r, ovalWidth, ovalHeight 
  41.  
  42. Input types:   Rect, integer, integer
  43.  
  44. Description:   Inverts the pixels enclosed by the specified rounded-corner rectangle:    every white pixel becomes black and every black pixel becomes white.
  45.  
  46.  
  47. __________________________________________
  48. FillRoundRect  *399*
  49.  
  50. Input names:   r, ovalWidth, ovalHeight, pat 
  51.  
  52. Input types:   Rect, integer, integer, Pattern
  53.  
  54. Description:   Fills the specified rounded-corner rectangle with the given pattern.
  55.  
  56.  
  57. __________________________________________
  58. Arcs and Wedges
  59.  
  60. In the following routines, startAngle indicates where the arc begins and is treated MOD 360.  ArcAngle defines the extent of the arc.
  61.  
  62.  
  63. __________________________________________
  64. FrameArc  *400*
  65.  
  66. Input names:   aRect, startAngle, arcAngle 
  67.  
  68. Input types:   Rect, integer, integer
  69.  
  70. Description:   Draws an arc of the oval that fits inside the specified rectangle using the current grafPort‚Äôs pen pattern, mode, and size.  
  71.  
  72.  
  73. __________________________________________
  74. PaintArc  *400*
  75.  
  76. Input names:   r, startAngle, arcAngle 
  77.  
  78. Input types:   Rect, integer, integer
  79.  
  80. Description:   Paints a wedge of the oval just inside the specified rectangle with the current grafPort‚Äôs pen pattern and mode. 
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90. __________________________________________
  91. EraseArc  *400*
  92.  
  93. Input names:   r, startAngle, arcAngle 
  94.  
  95. Input types:   Rect, integer, integer
  96.  
  97. Description:   Paints a wedge of the oval just inside the specified rectangle with the current grafPort‚Äôs background pattern bkPat.
  98.  
  99.  
  100. __________________________________________
  101. InvertArc  *400*
  102.  
  103. Input names:   r, startAngle, arcAngle 
  104.  
  105. Input types:   Rect, integer, integer
  106.  
  107. Description:   Inverts the pixels enclosed by a wedge of the oval just inside the specified rectangle:    every white pixel becomes black and every black pixel becomes white.
  108.  
  109.  
  110. __________________________________________
  111. FillArc  *401*
  112.  
  113. Input names:   r, startAngle, arcAngle, pat 
  114.  
  115. Input types:   Rect, integer, integer, Pattern
  116.  
  117. Description:   Fills a wedge of the oval just inside the specified rectangle with the given pattern.
  118.  
  119.  
  120. __________________________________________
  121. Bit Transfer 
  122.  
  123.  
  124. __________________________________________
  125. ScrollRect  *401*
  126.  
  127. Input names:   r, dh, dv, updateRgn 
  128.  
  129. Input types:   Rect, integer, integer, RgnHandle
  130.  
  131. Description:   Shifts the bits that are inside the intersection of the specified rectangle.  The bits are shifted a distance of dh horizontally and dv vertically. The bits that are shifted out of the scroll area are lost, they are neither placed outside the area nor saved.  The space created by the scroll is filled with the grafPort‚Äôs background pattern and the updateRgn is changed to this filled area.  ScrollRect doesn‚Äôt change the coordinate system of the grafPort, it simply moves the entire document to different coordinates. 
  132.  
  133.  
  134. __________________________________________
  135. CopyBits  *401*
  136.  
  137. Input names:   srcBits, dstBits, srcRect, dstRect, mode, maskRgn 
  138.  
  139. Input types:   Bitmap, Bitmap, Rect, Rect, integer, RgnHandle
  140.  
  141. Description:   CopyBits transfers a bit image between any two bit maps or pixel maps and clips the result to the area specified by the maskRgn parameter.  The transfer may be performed in any of the eight source transfer modes.  The source rectangle is completely aligned with the destination rectangle; if the rectangles are of different sizes, the bit image is expanded or shrunk as necessary to fit the destination rectangle.
  142.  
  143.  You can use the following constants to specify the source transfer mode. (For more information, see Inside Macintosh.) 
  144.  
  145. constant    value 
  146.  
  147. srcCopy    0    
  148.  
  149. srcOr    1    
  150.  
  151. srcXor    2    
  152.  
  153. srcBic    3    
  154.  
  155. notsrcCopy    4    
  156.  
  157. notsrcOr    5    
  158.  
  159. notsrcXor    6    
  160.  
  161. notsrcBic    7    
  162.  
  163.  
  164.  
  165. __________________________________________
  166. Pictures 
  167.  
  168.  
  169. __________________________________________
  170. OpenPicture  *402*
  171.  
  172. Input names:   picFrame 
  173.  
  174. Input types:   Rect
  175.  
  176. Output names:   PicHandle
  177.  
  178. Output types:   PicHandle
  179.  
  180. Description:   Returns a handle to a new picture that has the given rectangle as its picture frame, and tells QuickDraw to start saving as the picture definition all calls to drawing routines and all picture comments (if any). 
  181.  
  182.  
  183. __________________________________________
  184. ClosePicture  *402*
  185.  
  186. Description:   Tells QuickDraw to stop saving routine calls and picture comments as the definition of the currently open picture.  Only one ClosePicture should be performed for every OpenPicture. 
  187.  
  188.  
  189. __________________________________________
  190. PicComment  *403*
  191.  
  192. Input names:   kind, dataSize, dataHandle 
  193.  
  194. Input types:   integer, integer, Handle
  195.  
  196. Description:   Inserts the specified comment into the definition of the currently open picture. DataHandle is a handle to additional data if desired, and dataSize is the size of that data in bytes.  The kind parameter identifies the type of comment.
  197.  You can use the following constants to specify the kind parameter.  (For more information, see Inside Macintosh.)
  198.  
  199. constant value 
  200.  
  201. picLParen    0    
  202.  
  203. picRParen    1    
  204.  
  205.  
  206. __________________________________________
  207. DrawPicture  *403*
  208.  
  209. Input names:   myPicture, dstRect 
  210.  
  211. Input types:   PicHandle, Rect
  212.  
  213. Description:   Takes the part of the given picture that‚Äôs inside the picture frame and draws it in dstRect, expanding or shrinking it as necessary to align the borders of the picture frame with dstRect.
  214.  
  215.  
  216. __________________________________________
  217. KillPicture  *403*
  218.  
  219. Input names:   myPicture
  220.  
  221. Input types:   PicHandle
  222.  
  223. Description:   Releases the memory occupied by the given picture.
  224.  
  225.  
  226. __________________________________________
  227. GetPicture  *404*
  228.  
  229. Input names:   picID 
  230.  
  231. Input types:   integer 
  232.  
  233. Output names:   PicHandle
  234.  
  235. Output types:   PicHandle 
  236.  
  237. Description:   Returns a handle to the picture having the given resource ID, reading it from the resource file, if necessary.  If the resource can‚Äôt be read, GetPicture returns NIL.
  238.